accept
Type
command
Summary
Accepts an internet connection and creates a socket for that connection.
Syntax
accept [datagram] connections on port <portNumber> with message <callbackMessage>
Description
Use the accept command when running a server, to accept TCP connections or UDP datagrams from other systems (or other processes on the same system). Use the datagram option if you want to accept UDP datagrams.
When a connection is made or a datagram is received, the accept command creates a new socket that can be used to communicate with the other system (or process). When using the close socket, read from socket, or write to socket commands, you can refer to this socket with a socket identifier that looks like this: host
where the connectionID is a number assigned by the accept command. (You only need to specify the connection number if there is more than one socket connected to a particular port and host.)
The callbackMessage is sent to the object whose script contains the accept command. Either one or two parameters are sent with this message. The first parameter is the IP address of the system or process making the connection. If a datagram is being accepted, the second parameter is the contents of the datagram.
- For technical information about sockets, see RFC 147
- For technical information about UDP datagrams, see RFC 768
- For technical information about the numbers used to designate standard ports, see the official IANA list of port assignments and RFC 6335
- The defaultNetworkInterface property can be used to specify the interface to accept connections on.
Parameters
| Name | Type | Description |
|---|---|---|
callbackMessage | The name of a message to be sent when a connection is made or a datagram is received. | |
portNumber | The TCP port number on which to accept connections. |
Examples
accept connections on port 80 with message "connectionMade"
accept datagram connections on port 80 with message "connectionMade"
on mouseUp
accept connections on port 80 with message "connectionMade"
end mouseUp
on connectionMade pIPAddress
put "Connection made:" && pIPAddress
end connectionMade
accept connections on port 0 with message "connectionMade"
put it into tPort
Related
command: read from socket, write to socket, close socket, open socket
function: openSockets, hostAddressToName, hostName, hostAddress, peerAddress, hostNameToAddress
glossary: datagram, IP address, TCP, port, command, socket, UDP, host, server, message, parameter, process, object
property: HTTPProxy, script, defaultNetworkInterface
Compatibility and Support
Introduced
LiveCode 1.0
OS
mac
windows
linux
ios
android
Platforms
desktop
server
mobile